Static maps
Web services
Static maps API documentation, available via HTTP-JSON/XML service.
URL base service:
- HTTP requests in POST
- Response in JSON / XML format
You can get a static map using a image path, ore directly a bit array.
The maximum image size is &width=1680&height=1280. This size is in pixels.
Paint markers in the map
Request
Example:
https://lb.cercalia.com/services/v2/json?cmd=map&ctn=girona&ctryc=ESP&key=YOUR_API_KEY
Where:
| Parameter | Description |
|---|---|
cmd | map fixed parameter (request type = static map) |
width & height | Image size (in pixels) |
mocs | gdd coordinate system (gdd -> geographical lat,long). Optional |
extent | Y,X upper left |
molist | List of markers. Format: `[Y,X |
*Icons: the icon is specified by an integer numeric code (1,2,3 …). These icons must be published on the Cercalia platform servers.
Optional:
| Parameter | Description |
|---|---|
img | Returns the image, instead of a JSON / XML |
Response
If request includes &img= paramether, the response is the image (array of bits).
Otherwise, the response is in JSON/XML format, including the path for dowloading the image:
{
"cercalia": {
"@cmd": "map",
"@version": "1",
"proximity": {
"@center": "2.82360257,41.98164077",
"@num": "1",
"@op": "3"
},
"map": {
"@cmode": "rf",
"@smap": "0",
"@style": "default",
"img": {
"@center": "2.82360257,41.98164077",
"@format": "gif",
"@height": "250",
"@href": "/MapesNG/Cercalia/map/map48/90110337341.gif",
"@scale": "4",
"@width": "350",
"extent": {
"coord": [
{
"@x": "2.79240408",
"@y": "41.99826097"
},
{
"@x": "2.85479207",
"@y": "41.96501619"
}
]
}
},
"label": {
"@op": "1",
"@pt": "2.82360257,41.98164077",
"value": "Girona"
},
"poicats": {},
"shapes": {}
},
"server": {
"value": "lb.dev.cercalia.com"
},
"instance": {
"value": "http://master-cercalia-lbs-both-lines"
}
}
}
Where:
| Parameter | Description |
|---|---|
href | /MapesNG/Cercalia/map/map0/45891615731.gif Image path |
https://lb.cercalia.com | Server |
Path including server + image | https://lb.cercalia.com/MapesNG/Cercalia/map/map0/45891615731.gif |
Map example:
Paint polylines, areas and labels
Request
Example:
https://lb.cercalia.com/services/v2/json?cmd=map&width=400&height=300&labelop=0&mocs=gdd&cs=gdd&extent=41.439132726,2.003108336|41.390497829,2.197135455&shape=[255,0,0,128|2|0,255,0,128|CIRCLE|41.439132726,2.003108336|2000],[255,0,0|2|255,0,0|POLYLINE|41.401902461,2.142455003|41.404628181,2.155965665|41.433339308,2.179860852]&key=YOUR_API_KEY
Where &shape= paramether include several type of shapes: circle, rectangle, sector, line, polyline, label
Shape format:
[outline color | outline size | fill color | shape type | specific paramethers]
| Parameter | Description |
|---|---|
outline color | RGBA* format. |
outline size | In pixels. |
fill color | RGBA* format. |
shape type | shape. |
specific parameters | Specific parameters according to every type of shape. |
* RGBA format (red,green,blue,alpha):
| Parameter | Description |
|---|---|
Red | [value between 0-255] |
Green | [value between 0-255] |
Blue | [value between 0-255] |
Alpha | Transparency [value between 0 (transparent) – 255 (opaque)]. Default value: 255. |
Response
{
"cercalia": {
"@cmd": "map",
"@version": "1",
"proximity": {
"@op": "3"
},
"map": {
"@smap": "0",
"@style": "default",
"img": {
"@center": "2.1001174,41.41481986",
"@format": "gif",
"@height": "300",
"@href": "/MapesNG/Cercalia/map/map0/90110694631.gif",
"@scale": "6",
"@width": "400",
"extent": {
"coord": [
{
"@x": "1.95750985",
"@y": "41.49528225"
},
{
"@x": "2.24272496",
"@y": "41.33425693"
}
]
}
},
"label": {
"@op": "0",
"@pt": "2.1001174,41.41481986"
},
"poicats": {},
"shapes": {
"shape": [
{
"@type": "CIRCLE",
"outline": {
"@color": "255,0,0,128",
"@width": "2"
},
"fill": {
"@color": "0,255,0,128"
},
"params": {
"coord": {
"@x": "2.00310834",
"@y": "41.43913273"
},
"rad": {
"value": "2000.0"
}
}
},
{
"@type": "POLYLINE",
"outline": {
"@color": "255,0,0,255",
"@width": "2"
},
"params": {
"coord": [
{
"@x": "2.142455",
"@y": "41.40190246"
},
{
"@x": "2.15596567",
"@y": "41.40462818"
},
{
"@x": "2.17986085",
"@y": "41.43333931"
}
]
}
}
]
}
},
"server": {
"value": "lb.dev.cercalia.com"
},
"instance": {
"value": "http://master-cercalia-lbs-both-lines"
}
}
}
Example:
https://lb.cercalia.com/services/v2/json?cmd=map&ctn=Girona&shape=[255,0,0|3|0,255,0,128|RECTANGLE|316502,5132529|314502,5130528],[255,0,0,128|10|0,255,0,128|CIRCLE|314502,5130528|1000]&key=YOUR_API_KEY
**Shape types and specific paramethers:
CIRCLE
Draw a circle. Specific paramethers:
| Parameter | Description |
|---|---|
center | Y,X coordinate |
radius | Radius, in meters |
RECTANGLE
Draw a rectagle. Specific paramethers:
upper left coordinates | lower right coordinates
SECTOR
Draw a sector. Specific paramethers:
center | internal radius | external radius | start angle | end angle
| Parameter | Description |
|---|---|
center | Y,X coordinate |
internal radius | Radius, in meters, where the sector starts |
radio externo | Radius, in meters, where the sector ends |
start angle | Angle, in degrees, where the sector begins |
ángulo fin | Angle, in degrees, where the sector ends |
LINE
Draw a line. Fill color not available. Specific paramethers:
start coordinate | end coordinate
POLYLINE
Draw a polyline. Fill color not available. Specific paramethers:
coordinate 1 | coordinate 2 | .... | coordinate n
LABEL
Draw a label starting in a coordinate. Specific paramethers:
center | text
| Parameter | Description |
|---|---|
center | Coordinates, text starting point |
text | Label content |
Example:
